<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
    <META NAME="Title" CONTENT="SMS Server Tools 3">
    <META NAME="Robots" CONTENT="INDEX,FOLLOW">
    <META NAME="Language" CONTENT="English">
    <title>SMS Server Tools 3</title>
<STYLE type="text/css">
BODY {
  BACKGROUND: #ffffff; MARGIN: 5px 5px 10px; FONT: 10pt verdana, geneva, lucida, arial, helvetica, sans-serif; COLOR: #000000
}
td {
  FONT: 10pt verdana, geneva, lucida, arial, helvetica, sans-serif;
}
h3 {
  background-color: #DCDCFE;
}
blockquote {
  background-color: #FFD;
  font-size: 90%;
  padding:5pt;
  padding-top:1pt;
  margin-bottom:5pt;
  border-style: outset;
  border-color: #aaaa99;
  border-width: 0.05pt 2pt 2pt 0.05pt;
}
blockquote p:first-letter {
  font-size: 110%;
  font-weight: bold;
  color: red;
}
</STYLE>
  </head>

<body>
<h2><font color=blue><a href="http://smstools3.kekekasvi.com">SMS Server Tools 3</a></font></h2>
<a href="index.html">Home</a>
<h3>Blacklist and Whitelist</h3>
<!-- START --><p>
If you need to disable some receivers to get messages you can create a blacklist file.
<p>
This is a simple text file that contains the phone numbers of the receivers that you want to
disable. You can add comments that start with an # character.
</p><p>
Example:
</p><p>
<table border=1 bgcolor=lightgrey><TR><TD>
<font face="Courier New, Courier, monospace">
<br>
&nbsp;491721234567 # Michael Testman&nbsp;<br>
&nbsp;44 # Do not allow any number in UK&nbsp;<br>
&nbsp;s # Disallow all short numbers&nbsp;<br>
<br>
</font>
</TD></TR></table>
</p><p>
<b>Important note:</b><br>When you send a message, the destination number may be either in international format or in any format starting with an s. When somebody shall not receive messages, then you need to
do either
<ul>
  <li>Disallow all short numbers</li>
  <li>Blacklist regular international format <u>and</u> blacklist any alternative number formats. Start the alternative formats with an s. </li>
</ul>
Example:
</p><p>
<table border=1 bgcolor=lightgrey><TR><TD>
<font face="Courier New, Courier, monospace">
<br>
&nbsp;491721234567 # Michael Testman normal international format&nbsp;<br>
&nbsp;s00491721234567 # Michael Testman alternative international format&nbsp;<br>
&nbsp;s01721234567 # Michael Testman local format&nbsp;<br>
&nbsp;s1234567 # Michael Testman alternative local format&nbsp;<br>
<br>
</font>
</TD></TR></table>
</p>
<h3>Whitelist</h3>
<p>
If you need to enable only a specified list of receivers, then you can create a whitelist file.
Normally you do not have a whitelist - everybody can receive SM except those who are in the
blacklist. If a recipient phone number is in both files it will not get a SM. The blacklist is more important.
</p><p>
Example:
</p><p>
<table border=1 bgcolor=lightgrey><TR><TD>
<font face="Courier New, Courier, monospace">
<br>
&nbsp;491721234567 # Stefan Frings&nbsp;<br>
&nbsp;491721111111 # Test&nbsp;<br>
&nbsp;44 # Allow any destination in UK&nbsp;<br>
&nbsp;s8 # Allow all short numbers that start with an 8&nbsp;<br>
<br>
</font>
</TD></TR></table>
</p><p>
With the smsd version >= 3.1 whitelist can also specify a queue to be used.<br>
This overrides automatic number based selection and can be overridden by the queue setting in the message file.
</p><p>
Example:
</p><p>
<table border=1 bgcolor=lightgrey><TR><TD>
<font face="Courier New, Courier, monospace">
<br>
&nbsp;# Messages to Stefan and Test are queued normally,&nbsp;<br>
&nbsp;# because any queue is not yet defined.&nbsp;<br>
&nbsp;491721234567 # Stefan Frings&nbsp;<br>
&nbsp;491721111111 # Test&nbsp;<br>
<br>
&nbsp;# Messages to UK and s8 numbers will use a queue specified:&nbsp;<br>
&nbsp;[QUEUE1]&nbsp;<br> 
&nbsp;44 # Allow any destination in UK&nbsp;<br>
&nbsp;s8 # Allow all short numbers that start with an 8&nbsp;<br>
<br>
&nbsp;# Other short numbers will use another queue:&nbsp;<br>
&nbsp;[QUEUE2]&nbsp;<br>
&nbsp;s&nbsp;<br>
<br>
&nbsp;[] # Setting can be cleared with empty brackets.&nbsp;<br>
&nbsp;491722222222 # Another Test, queue not defined.&nbsp;<br>
<br>
</font>
</TD></TR></table>
</p>
<p>
Note: You can edit these files without restarting the program.
</p>
<p>
With the smsd version >= 3.1 you can also make a provider sorting using SQL tables, because message headers 
are read <b>after</b> the checkhandler is processed.
</p>
<hr>
</body>
</html>
